home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lawn.zip / LAWN.DOC < prev    next >
Text File  |  1991-07-09  |  10KB  |  228 lines
  1.  
  2.                   LAWN Control Program for the PC v1.10
  3.                  Copyright (c) 1991 by Adrienne Cousins
  4.                           All Rights Reserved
  5.  
  6.                               VersaWare
  7.                 30 Jennifer Street, Littleton, MA 01460
  8.                   508-486-9351 (Voice 9am-4pm Eastern)
  9.                    508-486-8507 (24 hour Support BBS)
  10.  
  11.  Lawn stands for Local Area Wireless Network.  It is manufactured by
  12.  O'Neill Communications, Inc. (OCI) in Princeton, New Jersey.
  13.  It is a small white box, 4" x 2" x 7" in size, that is attached to a
  14.  serial port with an included cable.  It uses Spread Spectrum Radio
  15.  frequency, to transmit data from Lawn to Lawn at distances of 100 to
  16.  500 feet away from each other.
  17.  
  18.  Lawns come with software that performs electronic mail functions, file
  19.  send operations, and modem and printer sharing.
  20.  
  21.  They can also be used to run remote communications programs such as
  22.  pcAnywhere, Carbon Copy, Remote2, Close-up, Co/Session and PC-Tools/Commute.
  23.  They also work well with all communications programs, and many stand-alone
  24.  protocol drivers such as DSZ and BIMODEM.
  25.  
  26.  This program provides a means of controlling a Lawn from the DOS prompt
  27.  without requiring the LAWNTSR program from OCI.  It also provides access
  28.  to many of the Lawn internal commands and functions that are not accessable
  29.  with the software from OCI.
  30.  
  31.  This is useful in batch files, when it may be desirable to connect two
  32.  Lawns for a file transfer or any other operation, and then disconnect
  33.  the Lawns when the operation is finished.  This will leave the target
  34.  Lawn available for connects from other systems.
  35.  
  36.  It also comes in handy if you want to attach a Lawn to an X10 Computer
  37.  Interface CP290.  A PC system can attach to the X10/Lawn, send commands to
  38.  program timed events and then disconnect, leaving both Lawns (and your
  39.  serial port) available for other operations.
  40.  
  41.  This is the reason that I wrote LAWN, and the remainder of the documentation
  42.  will address the issues involved in setting up your X10 on a Lawn.
  43.  
  44.                   -----------------------------------------
  45.  
  46.  LAWN command syntax & functions:
  47.  
  48.         LAWN <cmd>[,<cmd>][,<cmd>] [>>outfile]
  49.  
  50.  Where <cmd> can be any valid switches or Lawn command.
  51.  All commands are executed in the order that they appear in the command line.
  52.  
  53.  
  54.  Valid switches are as follows:
  55.  
  56.  ?      Print a short help text to the screen
  57.  
  58.  -A     Echo all Lawn I/O to the screen in ascii
  59.         Causes all data sent to or received from the Lawn to be echoed to
  60.         the screen in ascii.  This can also be redirected to any standard
  61.         output device or file.
  62.  
  63.                 LAWN -A,-I,MYCALL,MHEARD >TEST.LOG
  64.  
  65.  -Bn    Set baud rate of serial port (300-19200)
  66.         Causes the serial port to be set to the specified speed.  This
  67.         is useful following an ABAUD command to the Lawn:
  68.  
  69.                 LAWN -I,ABAUD 19200,-B19200
  70.  
  71.  -C     Put Lawn into command mode (cmd:)
  72.         Puts the Lawn into command mode so that it prints the 'cmd:' prompt
  73.         and is ready to accept commands.
  74.  
  75.                 LAWN -C,DISCON
  76.  
  77.  -H     Echo all Lawn I/O to the screen in hexadecimal
  78.         Causes all data sent to or received from the Lawn to be echoed to
  79.         the screen as hexadecimal bytes.  This data can also be redirected
  80.         to any standard output device or file.
  81.  
  82.                 LAWN -I,-H,-W >TEST.LOG
  83.  
  84.  -I     Initialize serial port to same speed as Lawn
  85.         Checks for the existence of a Lawn on the specified serial port
  86.         at all of the possible baud rates supported by the Lawn.  Once
  87.         a Lawn is detected, the serial port is set to the matching baud rate.
  88.         After the -I switch, the Lawn will be left in command mode (cmd:).
  89.  
  90.                 LAWN -I
  91.  
  92.  -Pn    Serial port that Lawn is connected to (1-4)
  93.         Use this switch to specify a serial port other the default of COM1.
  94.         Multiple -P switches may appear on the line, to send commands to
  95.         multiple serial ports in a single command.
  96.  
  97.                 LAWN -A,-P1,-I,MYCALL,-P2,-I,MYCALL
  98.  
  99.  -Tf:l  Change timeout counters (first:last)
  100.         The value called FIRST, is the timeout in ticks until the first
  101.         byte is received from the Lawn.  The value called LAST, is the
  102.         timeout in ticks after the last byte is received from the Lawn.
  103.         FIRST defaults to 36 (2 secs), and LAST defaults to 18 (1 sec).
  104.  
  105.  -W     Watch for any data received from the Lawn
  106.         This monitors the serial port for any data received from the Lawn.
  107.         It is only useful in conjunction with the -A and -H echo switches.
  108.         This mode is terminated on any keystroke.
  109.  
  110.                 LAWN -A,-W
  111.  
  112.  Valid Lawn LAWN commands are as follows, only the uppercased letters of
  113.  each command are required:
  114.  
  115.         ABaud n - Baud rate (n=300,600,1200,2400,4800,9600,19200)
  116.         ABOrt - abort any active process & disconnect
  117.         ANtenna n - Mode of antenna operation (0=switching,1=ant0,2=ant1)
  118.         AUtolf on/off - controls auto line-feed
  119.         AWlen 7/8 - data word length for serial port
  120.         Beacon x n - set beacon frequency (x=A,E n=0-250 1=3.3s)
  121.         BLink n - Lawn power light blink count per 5 seconds (n=0-8)
  122.         BReak - send a BREAK to far side Lawn
  123.         BREAKLen n - set length of break (0-250 1=33.3ms)
  124.         CHAn n - select Lawn channel (n=1-4)
  125.         CMdtime n - seconds delay required before ^Cs for cmd mode
  126.         COnnect - show connect state
  127.         COnnect name - direct connect to another Lawn
  128.         COnnect name [VIA n1 n2] - connect via lawn N1 and N2
  129.         CONOk on/off - control connect from other Lawns
  130.         CONVers - enable converse mode
  131.         CStatus - show channel status
  132.         DAytime - show current date & time
  133.         DAytime YYMMDDHHMM - set current date & time
  134.         DFc on/off - default connect on data from serial port
  135.         DFCN name - default connect Lawn name
  136.         DIGipean on/off - control use as a VIA Lawn
  137.         Disconnect - disconnect from other Lawn
  138.         DISP - display all internal LAWN variables
  139.         Echo on/off - control command line echo
  140.         EMail on/off - control email mode
  141.         EMSgs - check email status
  142.         MHClear - clear active LAWN list
  143.         MHeard - show active LAWNS in current system
  144.         MYcall - show name of local Lawn
  145.         MYcall name - set local Lawns name
  146.         NEwmode on/off - ON enters TRANS mode on CONNECT
  147.                          OFF stays in COMMAND mode
  148.         Ocimode on/off - ON stays in TRANS mode on CONNECT
  149.                          OFF enters TRANS mode on CONNECT
  150.         Paclen n - packet length (n=0-256)
  151.         PACTime x n - packet transmision frequency (x=A,E n=0-250 1=33ms)
  152.         PARity n - parity (0=none 1=odd 2=none 3=even)
  153.         REAd - read next received email message
  154.         REConne - reinitialize connection to current LAWN
  155.         RESet - reset all Lawn variables & counters to factory defaults
  156.         RESTart - reset counters & displays ROM version if MYCALL<>DFCN
  157.         REtry n - maximum number for TRIES counter (n=0-31)
  158.         SElftest - perform selftest & RESTART command
  159.         STatus - show number of outstanding transmissions
  160.         SYsnum n - set security code (n=0-65535)
  161.         TImeout n - disconnect time for DFC ON (n=0-250 1=5s)
  162.         Trans - enable TRANSPARENT mode
  163.         TRFlow on/off - control XON/XOFF handshake on RX line
  164.         TXFlow on/off - control XON/XOFF handshake on TX line
  165.         Xflow on/off - master switch for XON/XOFF handshake
  166.  
  167.                   -----------------------------------------
  168.  
  169.  Some special notes for connecting an X10 to a Lawn:
  170.  
  171.  Since both the Lawn and the X10 are DCE devices, you must cross pins
  172.  2 and 3 between the Lawn and the X10, using either a null-modem cable
  173.  or a break-out box.
  174.  
  175.  The Lawn that is to be connected to an X10 should initially be connected
  176.  to a PC and configured with the following command (you may replace the
  177.  two occurrances of X10 with any preferred 6 character name):
  178.  
  179.         LAWN -a,-i,di,reset,-i,ab 600,-b600,-c,my x10,dfcn x10,pact e 1
  180.  
  181.  This sets the Lawn to the factory defaults, then sets the baud rate to
  182.  600 baud which is required by the X10 hardware.  It then sets the Lawn
  183.  name and default-connect-to name to X10 (which you may change), and then
  184.  sets the PACTIME to EVERY 1 which is necessary so that any X10 software
  185.  won't timeout and think that the X10 isn't responding properly.
  186.  
  187.  This also leaves the Lawn in NEWMODE ON mode which causes any CONNECT
  188.  command to immediately enter TRANSPARENT mode instead of staying at
  189.  command mode (cmd:).
  190.  
  191.                   -----------------------------------------
  192.  
  193.  Here are some examples for using LAWN to control an X10 via a Lawn:
  194.  
  195.         LAWN -a,-i,di,ab 600,-b600,co x10 >x10.log
  196.         XA f=reset.x10 >>x10.log
  197.         LAWN -a,-c,di,ab 19200,-b19200 >>x10.log
  198.  
  199.         -a      echo all I/O to the screen in ascii
  200.         -i      initialize the serial port to match the Lawn
  201.         di      disconnect any prior active connection
  202.         ab 600  set the Lawn baud rate to 600 baud
  203.         -b600   set the serial port to 600 baud
  204.         co x10  connect to the Lawn called X10
  205.  
  206.         XA      runs a shareware program called XA, which forces the
  207.                 serial port to 600 baud.  You may run any X10 software
  208.                 you prefer at this point.
  209.  
  210.         -a      echo all I/O to the screen in ascii
  211.         -c      put Lawn in command mode (cmd:)
  212.         di      disconnect from the X10 Lawn
  213.         ab 19200 sets the Lawn speed to 19200 baud
  214.         -b19200 sets the serial port to 19200 baud                
  215.  
  216.                   -----------------------------------------
  217.  
  218.  Another alternative, is to use XL.EXE which is a copy of XA that I patched
  219.  so that it doesn't reset the speed of the serial port.  This allows you
  220.  to send commands to your X10 without having to reset the speed of the
  221.  sending Lawn to 600 baud and then reset it to it's normal speed.
  222.  
  223.         LAWN -a,-i,co x10 >x10.log
  224.         XL f=reset.x10 >>x10.log
  225.         LAWN -a,-c,di >>x10.log
  226.  
  227.  
  228.